home *** CD-ROM | disk | FTP | other *** search
/ Personal Computer World 2005 October / PCWOCT05.iso / Software / FromTheMag / RSS Owl 1.1.3 / rssowl_win32_1_1_3.exe / doc / INSTALL.txt < prev    next >
Text File  |  2005-07-17  |  5KB  |  89 lines
  1. /*   **********************************************************************  **
  2.  **   Copyright notice                                                       **
  3.  **                                                                          **
  4.  **   (c) 2003-2005 RSSOwl Development Team                                  **
  5.  **   http://www.rssowl.org/                                                 **
  6.  **                                                                          **
  7.  **   All rights reserved                                                    **
  8.  **                                                                          **
  9.  **   This program and the accompanying materials are made available under   **
  10.  **   the terms of the Common Public License v1.0 which accompanies this     **
  11.  **   distribution, and is available at:                                     **
  12.  **   http://www.rssowl.org/legal/cpl-v10.html                               **
  13.  **                                                                          **
  14.  **   A copy is found in the file cpl-v10.html and important notices to the  **
  15.  **   license from the team is found in the textfile LICENSE.txt distributed **
  16.  **   in this package.                                                       **
  17.  **                                                                          **
  18.  **   This copyright notice MUST APPEAR in all copies of the file!           **
  19.  **                                                                          **
  20.  **   Contributors:                                                          **
  21.  **     RSSOwl - initial API and implementation (bpasero@rssowl.org)         **
  22.  **                                                                          **
  23.  **  **********************************************************************  */
  24.  
  25. !! THIS DOCUMENT IS ONLY IMPORTANT IF YOU HAVE DOWNLOADED THE BINARIES OF RSSOWL !!
  26.     
  27.  
  28. Installation notes for RSSOwl:
  29. ------------------------------
  30.  
  31.      Step 1) Java Runtime Environment
  32.  
  33.     In order to use RSSOwl your computer must have installed Java.
  34.  
  35.     You can get Java from here: http://www.java.com/en/download/manual.jsp
  36.     
  37.     Follow the instructions as mentioned in "Step 2: Install" if necessary.
  38.  
  39.  
  40.     Step 2) Installation of the Standard Widget Toolkit (SWT) graphic libary
  41.  
  42.     If you get the following error after execution:
  43.  
  44.     "Exception in thread "main" java.lang.UnsatisfiedLinkError: no swt-win32-30xx in java.library.path", there are
  45.     some ways to get it start correctly:
  46.  
  47.     Windows:
  48.  
  49.       1)
  50.       Make sure the "rssowl.jar" and the "swt-win32-xxxx.dll" are in the same directory
  51.       (they should, after unzip). Doubleclick the JAR-File. If an error occurs, try to
  52.       execute the following command from the windows commandline:
  53.       "java -jar -Djava.library.path=<Path to RSSOwl> <Path to RSSOwl>\rssowl.jar"
  54.       Replace the <Path to RSSOwl> with the path to the Directory, where the DLL is in
  55.       (for example: "java -jar -Djava.library.path=c:\rssowl c:\rssowl\rssowl.jar").
  56.  
  57.     2)
  58.       Put the DLL into a directory, that is known anywhere, like "C:\windows" or "C:\windows\system32" or
  59.       the BIN-directory of you JDK.
  60.  
  61.  
  62. Updating from previous Versions:
  63. --------------------------------
  64.  
  65. Updating an existing RSSOwl is very easy!
  66.  
  67. All settings and favorites should be stored in your user-home directory in a folder
  68. called ".rssowl" that is independant from RSSOwl's installation folder.
  69.  
  70. On Windows ".rssowl" should be located in "/Documents and Settings/user.name/.rssowl".
  71. On Linux / Solaris take a look at "~/.rssowl", from the console by typing "cd ~/.rssowl"
  72. On Mac the folder is located in "~/Library/Preferences/rssowl".
  73.  
  74. ATTENTION: We recommend to make a Backup of the "rssowl" folder, since it is containing
  75.            all your settings and Favorites. Do so BEFORE installing the new Version. 
  76.  
  77. In the case you are able to locate that folder simply copy the new RSSOwl into the
  78. same folder of the old RSSOwl, overwriting it.
  79.  
  80. In the case you are not able to locate that folder simply run the old RSSOwl, goto
  81. "Preferences" and perform "Export Settings". That export also includes your favorites.
  82. In the new RSSOwl goto "Preferences" and select "Import Settings". That's it :).
  83.  
  84.  
  85. Support
  86. -------
  87.  
  88.     If there are still problems with execution, feel free to write in the RSSOwl-forums @ sourceforge
  89.     (http://sourceforge.net/forum/?group_id=86683) or visit #rssowl on irc.freenode.net.